home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 11 / Mac Magazin and MacEasy Magazine CD - Issue 11.iso / Sharewarebibliothek / Entwickler / Drop UNIX 1.1 / DropUNIX Documentation
Text File  |  1995-05-25  |  4KB  |  87 lines
  1. DropUNIX 1.1
  2. ============
  3. By: Ryan Davis <davis@wln.com>
  4.  
  5. CHANGES:
  6. --------
  7. I waited for CW 6 before releasing this version. This release is a bug fix
  8. release. Using the new SIOUX library takes care of any errors that may have
  9. occured with SIOUX (seems stable, and QC no longer reports any errors). I 
  10. completely rewrote how data was passed around and removed all globals that
  11. I was using before. This was for two reasons: I hate globals, and there
  12. seemed to be a bug in malloc (I'm not sure if it was my bug, or a bug
  13. in MW's code) so all allocation is done with NewPtr & NewHandle. Last, but
  14. not least, changes have been made to accomodate THINK C's console. It behaves
  15. better, and seems to be a little more understandable. Again, documentation
  16. sucks, so does the interface... Both will come in version 2.0...
  17.  
  18. Why did I write DropUNIX?
  19. -------------------------
  20. Basically I was tired of writing support for some sort of user interface
  21. for unix ports. What it really comes down to is I dislike both Symantec's and
  22. MetroWerk's cconsole call. I thought, "Mac users don't DO pathnames... It
  23. is even discouraged by Apple...". So I wrote this little library allowing
  24. people to convert their ugly console app with no real interface to at LEAST
  25. be drag & drop.
  26.  
  27. How does it work?
  28. -----------------
  29. To be honest... I wrote very little of this. It is a small conversion of
  30. Leonard Rosenthal's DropShell 2.0. What _I_ did was take his dropShell and
  31. have it process files in it's usual  manner, except, rather than processing
  32. files right there, it creates a list of pathnames of the files dropped on
  33. the app. THEN when the processing is done, it passes the number of files+1
  34. (argc) and the list of "command line arguments" (argv) to Main (notice the
  35. case).
  36.  
  37. How do I use it?
  38. ----------------
  39. Well, this is the nice part. It comes precompiled into a library. So all
  40. you have to do is start a new application project (or duplicate the examples
  41. project) add all your unix files, the DropUNIX library, and the DropUNIX
  42. resources file. Don't forget to make the creator '∂UNX' (delta = option-d).
  43. Then, include "Main.h" in the same file that has your original main(...). It
  44. has a #define to convert your main(...) to Main(...), so linkage is
  45. automatic once you compile...
  46.  
  47. Why should I use it?
  48. --------------------
  49. Simplicity for the first part. You don't have to do much of anything to get
  50. it up. Second, to maintain Apple's Human Interface Guidelines. I hate, You
  51. hate, we all hate icky GUI's! Last, but not least Productivity. By using
  52. DropUNIX you have increased your productivity by giving the port a new
  53. interface for free, and you have increased your users productivity by giving
  54. them an interface they can use intuitively...
  55.  
  56. Why shouldn't I use it?
  57. -----------------------
  58. Because a lot of unix apps change options through flags, if you require these
  59. flags to be settable, you are out of luck for now... Well, this isn't entirely
  60. true... If one REALLY needs a flag, say '-f' they can make a folder with the
  61. name '-f' and include that in the drop, then the flag would get there... It
  62. just seems wierd to have to do that....
  63.  
  64. Also, if ordering is important, then one would have to physically rename
  65. their files to be: 1.aFile, 2.anotherFile... etc, because the finder sends
  66. the files in alphabetical order...
  67.  
  68. Planned Changes:
  69. ----------------
  70. In the next major release, I will write a simple interface that comes up (if
  71. option is held down?) and allows one to modify the order, add flags easily, etc.
  72.  
  73. How do I modify and recompile DropUNIX?
  74. ---------------------------------------
  75. Because DropUNIX was based entirely on DropShell 2.0, I did not distribute ANYTHING but the
  76. modified files. If you would like to make modifications to this library and recompile it,
  77. go ahead. I've included all the other DropShell files to avoid confusion...
  78.  
  79. OK, what does it cost me?
  80. -------------------------
  81. All I want is email. Whether you use it or not, I'd appreciate a simple email from anyone
  82. who downloads it. This is more to see how many people are even interested in the stuff that
  83. I am planning to put out than it is a real need for email... I mean, come on, I _do_ have a
  84. life!
  85.  
  86. Ryan Davis
  87. davis@wln.com